home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 2 / CU Amiga Magazine's Super CD-ROM 02 (1996)(EMAP Images)(GB)[!][issue 1996-04].iso / magazine / amiga_e / ez_e_2.00 / ez_e.doc < prev    next >
Text File  |  1993-08-25  |  8KB  |  157 lines
  1. /****************************************************************************\
  2.  ******************      ! ! ! W A R N I N G ! ! !        *******************
  3.  
  4.                    THIS IS A BETA VERSION OF THE SOFTWARE
  5.                      NOT ALL FUNCTIONS ARE IMPLEMENTED
  6.  
  7.  ******************      ! ! ! W A R N I N G ! ! !        *******************
  8. \****************************************************************************/
  9.  
  10. Ez_E V2.00 by Kevin Connell
  11.  
  12.   This is a simple GUI interface to use with E.  I wrote it to make programming
  13. in E a simpler task.  I disliked shuffling windows around, opening a shell
  14. 'CD'-ing to the right directory, and doing all that typing.
  15.  
  16. Ez_E makes E Ez!!!
  17.  
  18.   It's really just a simple cover that replaces all that window shuffling and
  19. typing. There are 8 simple buttons that should be self explanatory, but the use
  20. of each is as follows:
  21.  
  22. Editor:  This will open your editor.  It will present you a file requestor, and
  23.          all you need to do is locate your current work file.  It will
  24.          automatically pass the name of this file to your editor, so don't worry
  25.          about passing command strings.
  26.  
  27. Project: This allows you to save each individual project you are working on.
  28.          Information saved includes: Path and name of current source file,
  29.          current Compiler options, current execute options, and whether you
  30.          are using a precompiler or not.
  31.         ** Note: When you open a new project with this button, Ez_E will
  32.            automatically open the source in your editor, set the proper state on
  33.            PCP, and fill in the strings for compiling and execution.
  34.  
  35. PCP:     This button will toggle useage of ANY file Pre-Compiler. Note that if
  36.          you are using EPP, you must have it properly installed (see the docs
  37.          on how to use EPP). It cycles between the on and off stage, and the
  38.          current setting is saved in the PROJECT.
  39.  
  40.  
  41. Compile: This button will compile your program.  All output from the compiler
  42.          will appear in the 'Ez_E IO window' so you can see what it is doing.
  43.         ** Note: that you should have selected a work file with editor before
  44.            using this button, but if you didn't, it will ask you for an .e file
  45.            to use as the object.
  46.         ** Note: If you are using a pre-compiler, Compile will automatically call
  47.            your pre-compiler before it calls EC.
  48.         ** Note: New in 2.00; you can now add a command line string in the gadget
  49.            to the right of this button. THIS COMMAND LINE IS ONLY PASSED TO EC,
  50.            AND NOT TO ANY PRECOMPILER!!!
  51.            The current command line string is saved when you save your project.
  52.  
  53. Execute: This will (attempt to) run the program you are currently working on with
  54.          optional command line arguments.
  55.          If you have not opened a project with the editor or the compiler button,
  56.          it will do nothing at all.  Currently opens a full screen window to run
  57.          your program in.
  58.         ** Note: New in 2.00; you can now add a command line string in the gadget
  59.            to the right of this button. The current command line string is saved
  60.            when you save your project.
  61.  
  62. Config:  Not yet implemented. You need to do this:
  63.  
  64.          If upgrading from an early Ez_E, delete the file "S:Ez_E.cfg"
  65.          Start Ez_E
  66.          Exit Ez_E
  67.          Use a text editor to open the file "S:Ez_E.Cfg"
  68.          Change the arguments to what you require
  69.          Save the file
  70.          Restart Ez_E, and press Config. You will get a dump of the internal
  71.            settings. If they do not match what you typed in, delete S:Ez_E.cfg
  72.            and start over.
  73.  
  74.     Defaults: Path to EC     = 'C:'       This is where Ez_E will look for EC to
  75.                                           compile the programs.
  76.               Path to Editor = 'C:'       This is where Ez_E will look for your
  77.                                           editor.
  78.               Name of Editor = 'MeMacs'   This is the name of the default editor.
  79.               Work Directory = 'RAM:'     This is where Ez_E will look for your
  80.                                           .e source.
  81.               Project Path   = 'RAM:'     This is where your project files are
  82.               Path to PCP    = 'C:'       This is where Ez_E will look for your
  83.                                           pre-compiler.
  84.               Name of PCP    = 'Include'  Options: EPP, Include
  85.                                           !!! NOTE: A PCP is NOT required to be
  86.                                               used with Ez_E!!!
  87.               Using a PCP?   = 'Y'        Options: Y / N
  88.  
  89. About:   Just a little requester with some info about me in it.
  90.  
  91. Exit:    Use this to exit Ez_E. (What did you expect?)
  92.  
  93. And thats it!  Short, simple, and Ez to use.
  94.  
  95. Disclaimer:
  96.          This program SHOULD operate properly when used according to the
  97.          guidelines specified in this document.  In no instance will I be liable
  98.          for any damage caused or data lost by the use or misuse of Ez_E.
  99.  
  100. Bugs:    None known (so far).  It seems to be a clean program.
  101.          If you do find any, you can contact me at:
  102.  
  103.              FreshWaterII    40:401/100.0@AmigaNet (Best)
  104.                               1:209/239.0@FidoNet  (Good)
  105.          Or
  106.              4834 San Rafael Ave.
  107.              Las Vegas, Nevada 89120
  108.  
  109. Distribution:
  110.          Ez_E is copyright © 1993, by Kevin Connell, All Rights Reserved
  111.          This program is postcardware.  If you use/like/love it, just send me a
  112.          postcard.  Please do not distribute it with any commercial package.
  113.          In any case, you cannot charge more for a copy of this program than
  114.          the cost of the materials (disk) and reasonable wear on a drive.
  115.          (Not to exceede a total cost of $1.00) without my written permission.
  116.          Source is available, just drop me a line, with enough money to pay for
  117.          a disk and postage (or if you want to freq it, just send me netmail).
  118.  
  119. History:
  120.  
  121.   V1.0   Written on May 10, 1993.  Really just as a test of some stuff in 'E'.
  122.          Updated May 31, Same revision, made it a bit more friendly.
  123.  
  124.   V1.1   Updated May 31, made 2.0 specific. Released to file echo.
  125.  
  126.   V1.2   Updated June 27, Added support for EPP preprocessor.
  127.          Changed the config stuff around a bit, hopefully better.
  128.          Not Released to file echos.
  129.  
  130.   V1.3   Updated July 26, Changed support from EPP to any preprocessor.
  131.          Added New Button, "CLI Exec", so you could launch programs with
  132.          arguments (like from CLI).
  133.          Released to file echo.
  134.  
  135.          Fixed Bug in "CLI Exec" button. Was adding an extra ^@ to the end of
  136.          the command line.
  137.          Included a simple pre-processor called "Include", and a replacement
  138.          for "Execute" that features a file requester (w/source).
  139.  
  140.   V2.00  Beta Version - Updated August 25
  141.          Complete re-write from the ground up. Broke the code into modules,
  142.          and used Include to reconstruct it.
  143.          Added commandline options for EC, and for executing. Made output
  144.          window resizeable, for ease of use. Window is now "Font Smart", and
  145.          adjusts up to about a 14 point font with no problems.
  146.          Implemented "Projects", a sub configuration.
  147.  
  148. To Do:
  149.  
  150.          GET THE CONFIG BUTTON WORKING!!! (Actually, it had been a while, and
  151.          Ez_E had improved so much, I wanted to get a new version out there).
  152.  
  153.          Thought: How often do you change your main config? Maybe I should
  154.          just write a small config program, and leave this space open for a
  155.          new function????
  156.  
  157.          Add an Arexx port, so any rexx capable editor can activate Ez_E.